<script type="text/javascript"
     src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<head>
    <link rel="stylesheet" href="stylesheet_TMATS.css">
</head>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<title>
    T-MATS: Help for Splitter (Cantera) Library Block
</title>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<body>
    <h1>
      T-MATS: Splitter (Cantera) Library Block
    </h1>
<hr>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="purpose">
        Purpose
</div>

<p>
    This block is used to simulate the performance of a splitter using
    basic flow fluid dynamic equations and <a href="FunM_TMATSC.html">T-MATS Cantera functions</a>.
</p>

<br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="background">
        Background
</div>

<p>
    To compute the output flow parameters, this block utilizes <a href="FunM_TMATSC.html">T-MATS Cantera functions</a>
    (flowcopy), then adjusts the primary and secondary flow magnitude according to the following equations:

<p> For the primary (main/core) flow path:

    $$ W_p = \frac{W}{1+BPR} $$

<p>
    For the secondary (bypass) flow path:

    $$ W_s = \frac{W*BPR}{1+BPR} $$
</p>
<p>
    Unless adjusted by one of the previous equations, all of the other
    flow variables remain constant across this block.
</p>
<br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="instructions">
        Instructions
</div>

<p>
    To use this block:
    <ul>
        <li> Ensure that a Cantera object exists in the workspace as a global
        variable named 'fs' and contains all of the species defined in the
        file 'canteraload.m'.
        <br>
        &nbsp;&nbsp;<em>Note:</em>This can be created with the Cantera 'importPhase'
        command.
        <li> Connect the flow input and bypass ratio inputs to the corresponding
        places on the block.
        <li> Connect the outputs to the next blocks in your simulation.
    </ul>
</p>

<br><hr><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="inputs">
       Splitter (Cantera) Inputs
</div>

<table>
    <tr><th> Input </th><th>Description</th></tr>
    <tr><td>Flow In</td><td>Flow Data Input, 25x1 vector consisting of:
            <br>-1-&nbsp;&nbsp; W &nbsp;&nbsp;     - Gas path flow [pps]
            <br>-2- &nbsp;&nbsp;s  &nbsp;&nbsp;   - Entropy [BTU/(lbm*degR)]
            <br>-3-&nbsp;&nbsp; Tt  &nbsp;&nbsp;   - Total temperature [degR]
            <br>-4-&nbsp;&nbsp; Pt  &nbsp;&nbsp;   - Total pressure [psia]
            <br>-5-&nbsp;&nbsp; ht   &nbsp;&nbsp;  - Total enthlapy [BTU/lbm]
            <br>-6-&nbsp;&nbsp; rhot  &nbsp;&nbsp;- Total density [lbm/ft3]
            <br>-7- &nbsp;&nbsp;gamt &nbsp;&nbsp; - Total specific heat ratio
            <br>-8-&nbsp;&nbsp; Ts   &nbsp;&nbsp; - Static temperature [degR]
            <br>-9- &nbsp;&nbsp;Ps  &nbsp;&nbsp;  - Static pressure [psia]
            <br>-10-&nbsp;&nbsp; hs  &nbsp;&nbsp;  - Static enthalpy [BTU/lbm]
            <br>-11-&nbsp;&nbsp; rhos &nbsp;&nbsp; - Static density [lbm/ft3]
            <br>-12- &nbsp;&nbsp;gams &nbsp;&nbsp; - Static specific heat ratio
            <br>-13-&nbsp;&nbsp; Vflow &nbsp;&nbsp; - Flow velocity [ft/sec]
            <br>-14- &nbsp;&nbsp;MN &nbsp;&nbsp; - Mach number
            <br>-15- &nbsp;&nbsp;A    &nbsp;&nbsp; - Flow area [in2]
            <br>-16to21- &nbsp;&nbsp;Species array values, defined in canteraload.m
            <br>-22to25- &nbsp;&nbsp;Future use
        </td></tr>
        <tr><td>BPR</td><td>Bypass Ratio</td></tr>
</table>

<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="outputs">
        Splitter (Cantera) Outputs
</div>

<table>
    <tr><th> Output </th><th> Description </th></tr>
    <tr><td>Flow Secondary</td><td>Flow Secondary, 25x1 vector defined as Flow In above</td></tr>
    <tr><td>Flow Primary</td><td>Flow Primary, 25x1 vector defined as Flow In above</td></tr>
    <tr><td>S_Data</td><td>Splitter Data, additional calculation data</td></tr>
</table>

<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="maskvars">
        Splitter (Cantera) Mask Variables
</div>
<p>
    No mask variables are needed for this block, since all of the calculations
    depend only on the inputs.
</p>
<br><hr><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class = "errors">
    Potential Errors
</div>
<p>
    When using this block, an error will occur if a Cantera object does not exist
    in the workspace as a global variable named 'fs'. An error will also occur
    if this variable does not contain all of the species defined in 'canteraload.m'.
</p>
<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
</body>